voxelop_release README
=================

1. 개요
  src\Test.java 는 libs\voxel-operator-1.0.16.jar 의 VoxelOpBuffer.buffer 연산을 실행하는 예제 프로그램
  - 입력 : 64x64x64 BIT 큐브 1개, 중앙에 10x10x10 정육면체 형상 (input.bdc)
  - 연산 : VoxelOpBuffer.buffer(cubes, Neighbor.N18, 10)
  - 출력 : result0.bdc (버퍼 결과 큐브), 실행한 폴더에 생성

2. 환경
  JDK 17 이상 (javac, java 명령이 PATH 에 등록되어 있어야 함)
  - 설치확인:
      java -version
      javac -version

3. 폴더 구조
   - docs : API 문서
   - libs : 공간연산자 jar 파일 저장
   - scenario : 시연을 위한 기능별 데이터 및 파라미터 정의
   - src : 공간연산자를 활용하는 간단한 샘플 코드
   - viewer : 공간연산자 실행 결과를 확인하는 도구

4. 공간연산자 샘플 코드 컴파일&실행
  프로젝트폴더(voxelop_release)에서 더블클릭
  - clear.bat -> 컴파일&실행 결과물 삭제
  - test.bat -> 컴파일&실행 (결과물생성)
      컴파일된 Test.class 는 out 폴더에 생성
      정상실행시 생성파일: result0.bdc

5. 파일 확장자 bdc
  - "bdc"라는 명칭은 "BasicDataCube"의 약자
  - "BasicDataCube 자료구조 정의(공간데이터큐브 포맷정의서)"를 binary포맷으로 저장한 파일

6. 결과확인
   시각화 브라우저에서 input.bdc 및 result0.bdc 확인

7. api문서
  docs\ 디렉토리에 저장

8. 시나리오
  15개 연산자에 대한 222개 주요 기능 시험 시나리오
  시나리오폴더(scenario)에서 더블클릭
  - clear.bat -> 시나리오결과 삭제
  - runner.bat -> 시나리오실행 및 결과생성
  - viewer.bat -> 시나리오 뷰어 실행

9. 복셀연산자뷰어
  - 서울 건물 및 고양시 지형 뷰어
  - 뷰어폴더(viewer)에서 더블클릭
  - viewer.bat -> 복셀연산자뷰어 실행
  - 예제 동영상을 통해 사용법 확인 가능
